Skip to content

feat: add code-tour skill — AI-generated CodeTour walkthroughs#1277

Merged
aaronpowell merged 5 commits intogithub:stagedfrom
vaddisrinivas:add-code-tour-skill
Apr 12, 2026
Merged

feat: add code-tour skill — AI-generated CodeTour walkthroughs#1277
aaronpowell merged 5 commits intogithub:stagedfrom
vaddisrinivas:add-code-tour-skill

Conversation

@vaddisrinivas
Copy link
Copy Markdown
Contributor

Summary

Adds the code-tour skill — an AI-powered CodeTour generator that creates persona-targeted, step-by-step .tour files linking to real files and line numbers in any repository.

What it does

  • Creates CodeTour-compatible .tour JSON files for VS Code
  • Supports 20 developer personas (new joiner, bug fixer, architect, PR reviewer, vibecoder, security reviewer, performance optimizer, and more)
  • Covers all CodeTour step types: file/line, selection, pattern, uri, commands, directory, view
  • Supports tour-level fields: ref, isPrimary, nextTour for multi-tour series
  • Works with any repository in any language — includes entry-point maps for Node/TS, Python, Go, Rust, Java, Ruby, PHP, and more
  • Includes depth controls (quick/standard/deep) and repo-type-specific strategies (monorepo, API, CLI, library, frontend, data pipeline)

Links

Checklist

  • Skill folder created at skills/code-tour/SKILL.md
  • Frontmatter includes name and description
  • Branch created from staged
  • PR targets staged branch

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2026

🔍 Skill Validator Results

2 resource(s) checked | ✅ All checks passed

Full output
Found 1 skill(s)
[code-tour] 📊 code-tour: 5,620 BPE tokens [chars/4: 5,617] (comprehensive ✗), 28 sections, 5 code blocks
[code-tour]    ⚠  Skill is 5,620 BPE tokens (chars/4 estimate: 5,617) — "comprehensive" skills hurt performance by 2.9pp on average. Consider splitting into 2–3 focused skills.
�[32m✅ All checks passed (1 skill(s))�[0m

@vaddisrinivas
Copy link
Copy Markdown
Contributor Author

Closing — will resubmit as separate PRs per skill, following contribution guidelines.

@vaddisrinivas
Copy link
Copy Markdown
Contributor Author

Reopened with fixes — SKILL.md trimmed from 633 to 432 lines (under 500 limit). Validator now passes. Previous closing comment was from an earlier version.

Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The README needs to be updated with the change to the skills. Run npm run build to update them.

vaddisrinivas and others added 3 commits April 9, 2026 13:46
Reduce persona table to top 10, condense verbose examples and notes,
trim redundant anti-patterns, compress step type docs and PR recipe.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The SKILL.md refers to some files that don't exist in the PR

vaddisrinivas and others added 2 commits April 10, 2026 07:56
Addresses reviewer feedback — SKILL.md referenced bundled files
(validate_tour.py, generate_from_docs.py, codetour-schema.json,
examples.md) that were not included in the PR.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@aaronpowell aaronpowell merged commit 09049e3 into github:staged Apr 12, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants